From aeda451da07d523d17664148175ec0b2c77b5c72 Mon Sep 17 00:00:00 2001 From: parkrrrr Date: Thu, 18 May 2006 02:20:43 +0000 Subject: [PATCH] more option motion --- xmldoc/filters/options/simplify-count.xml | 9 +++- .../filters/options/simplify-crosstrack.xml | 10 ++++ xmldoc/filters/options/simplify-error.xml | 14 ++++- xmldoc/filters/options/simplify-length.xml | 5 +- xmldoc/filters/simplify.xml | 52 +++++++------------ xmldoc/formats/lowranceusr.xml | 13 ++--- xmldoc/formats/options/lowranceusr-break.xml | 5 +- .../options/lowranceusr-ignoreicons.xml | 4 +- xmldoc/formats/options/lowranceusr-merge.xml | 4 +- 9 files changed, 69 insertions(+), 47 deletions(-) diff --git a/xmldoc/filters/options/simplify-count.xml b/xmldoc/filters/options/simplify-count.xml index 8b1378917..9b268a3c9 100644 --- a/xmldoc/filters/options/simplify-count.xml +++ b/xmldoc/filters/options/simplify-count.xml @@ -1 +1,8 @@ - + +This option specifies the maximum number of points which may appear in the +simplified route. For example, if you specify "count=50", all resulting +routes will contain 50 points or fewer. + + +You must specify either this option or the option. + diff --git a/xmldoc/filters/options/simplify-crosstrack.xml b/xmldoc/filters/options/simplify-crosstrack.xml index 8b1378917..3b3c2831e 100644 --- a/xmldoc/filters/options/simplify-crosstrack.xml +++ b/xmldoc/filters/options/simplify-crosstrack.xml @@ -1 +1,11 @@ + +This option instructs GPSBabel to remove points that have the smallest +overall effect on the overall shape of the route. Using this method, the +first point to be removed will be the one that is closest to a line drawn +between the two points adjacent to it. + + +If neither this option nor the option is specified, +this is the default. + diff --git a/xmldoc/filters/options/simplify-error.xml b/xmldoc/filters/options/simplify-error.xml index 8b1378917..dec87de10 100644 --- a/xmldoc/filters/options/simplify-error.xml +++ b/xmldoc/filters/options/simplify-error.xml @@ -1 +1,13 @@ - + +This option specifies the maximum allowable error that may be introduced +by removing a single point. The value of this option is a distance, +specified in miles by default. You may also specify the distance in +kilometers by adding a 'k' to the end of the number. + + +How the error is determined depends on whether the +or method is used. If you are using the length +method, the error is the change in the length of the route introduced by +removing a point. If you are using the crosstrack method, the error is the +distance from the point to the line that results if that point is removed. + diff --git a/xmldoc/filters/options/simplify-length.xml b/xmldoc/filters/options/simplify-length.xml index 8b1378917..0842f2f1f 100644 --- a/xmldoc/filters/options/simplify-length.xml +++ b/xmldoc/filters/options/simplify-length.xml @@ -1 +1,4 @@ - + +This option instructs GPSBabel to simplify by removing points that cause the +smallest change in the overall length of the route first. + diff --git a/xmldoc/filters/simplify.xml b/xmldoc/filters/simplify.xml index c445eba0a..976f61901 100644 --- a/xmldoc/filters/simplify.xml +++ b/xmldoc/filters/simplify.xml @@ -1,33 +1,21 @@ - - - The Simplify filter is used to simplify routes and - tracks for use with formats that limit the number of points - they can contain or just to reduce the complexity of a route. - The Simplify filter attempts to remove points from each - route until the number of points or the error is within the given - bounds, while also attempting to preserve the shape of the original - route as much as possible. - You must specify either the "count" option or the "error" option. - The count option requires a number, which is the maximum number - of points that will appear in the simplified track. The error - option takes a distance, optionally followed by an 'm' for miles or - a 'k' for kilometers. That distance specifies the maximum error; - how that error is determined depends on the simplification method, - described next. - You may also specify the method by which the filter chooses - which points to remove. The options are "length", which tries to - remove points that have the smallest effect on the overall length - of the route, or "crosstrack", which tries to remove points that - have the smallest overall effect on the shape of the route. The - default, if you don't specify either option, is "crosstrack". - The quality of the results will vary depending on the - density of points in the original route and the length of the - original route. - For example, suppose you have a route from Street - Atlas 2003 that you wish to use with a Magellan GPS receiver - that only supports up to 50 points in a route: - gpsbabel -r -i saroute -f RoadTrip.anr \ - -x simplify,count=50 \ - -o magellan -F grocery.rte - + +The Simplify filter is used to simplify routes and tracks for use with +formats that limit the number of points they can contain or just to +reduce the complexity of a route. + + +The filter attempts to remove points from each route until the number +of points or the error is within the given bounds, while also attempting +to preserve the shape of the original route as much as possible. + + +The quality of the results will vary depending on the density of points +in the original route and the length of the original route. + + +For example, suppose you have a route from Street Atlas 2003 that you +wish to use with a Magellan GPS receiver that only supports up to 50 points +in a route: + +gpsbabel -r -i saroute -f RoadTrip.anr -x simplify,count=50 -o magellan -F grocery.rte diff --git a/xmldoc/formats/lowranceusr.xml b/xmldoc/formats/lowranceusr.xml index 86211d5e8..79a34410a 100644 --- a/xmldoc/formats/lowranceusr.xml +++ b/xmldoc/formats/lowranceusr.xml @@ -1,14 +1,9 @@ - - - - The Lowrance iFinder GPS series has the unique capability + +The Lowrance iFinder GPS series has the unique capability to output its data to an MMC card. The data is saved to the card as a .USR file and can be read by your computer using a card reader. Waypoints, routes, tracks are supported. By default, Event marker icons are converted to waypoints. Symbols tend to get lost in the -translation. - Additional options: ignoreicons - don't convert icons to -waypoints merge - (USR output) merge all tracks into a single track -with segments break - (USR input) break track segments into separate -tracks +translation. + diff --git a/xmldoc/formats/options/lowranceusr-break.xml b/xmldoc/formats/options/lowranceusr-break.xml index 8b1378917..fc1503704 100644 --- a/xmldoc/formats/options/lowranceusr-break.xml +++ b/xmldoc/formats/options/lowranceusr-break.xml @@ -1 +1,4 @@ - + +This option breaks track segments into separate tracks when reading a .USR +file. + diff --git a/xmldoc/formats/options/lowranceusr-ignoreicons.xml b/xmldoc/formats/options/lowranceusr-ignoreicons.xml index 8b1378917..7930731c0 100644 --- a/xmldoc/formats/options/lowranceusr-ignoreicons.xml +++ b/xmldoc/formats/options/lowranceusr-ignoreicons.xml @@ -1 +1,3 @@ - + +This option instructs GPSBabel to not convert icons to waypoints on input. + diff --git a/xmldoc/formats/options/lowranceusr-merge.xml b/xmldoc/formats/options/lowranceusr-merge.xml index 8b1378917..f5c8721b3 100644 --- a/xmldoc/formats/options/lowranceusr-merge.xml +++ b/xmldoc/formats/options/lowranceusr-merge.xml @@ -1 +1,3 @@ - + +This option merges all tracks into a single track with multiple segments. + -- 2.30.2